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INTRODUCTION 



R/C PERMITS a USER AT A REMOTE TELETYPEWRITER TO CREATE AND 
MAINTAIN SOURCE OR DATA FILES ON THE B5500 SYSTEM DISK, FILE 
TYRES CREATED AND MAINTAINED WITH R/C ARE» ALGOL* XALGOL* COBOL* 
FORTRAN* BASIC* AND DATA. THESE FILES REPRESENT NORMAL (80 
CHARACTER*PER-CARO) PUNCHED CARD DECKS EXCEPT THAT THEY ARE 
STORED ON THE DISK. EACH RECORD CAN BE THOUGHT OF AS ONE CARD* 



r/c allows the user tot 

* create a variety of files 

* resequence files 

* print or punch files 

* delete or insert records into a file 

* modify records within a file 

* scan a file for the occurrence qf a string 
(optionally replacing it with another string) 

* remove files 

* compile files 

* perform many other functions 

the teletypewriter (in conjunction wlth the program r/c) can 
be considered a keypunch extension which eliminates punched cards* 
it offers great flexibility in file handling, 

r/c has two major restrictions? 

while the sequence number 99999999 is permitted for 
convenience* the maximum sequence number is 2097151 (2*21-l)» 

the maximum number of records permitted in a file is 

8191, 

IN THE DISCUSSION OF CERTAIN R/C VERBS* SOME OF THE ELEMENTS 
OF THE SYNTAX ARE GIVEN AS <M>* <N>* <I>* OR <J>. IN EACH CASE* 
THESE ELEMENTS REPRESENT INTEGER VALUES WHICH MUST BE PROVIDED BY 
THE USER. THE VALUE MAY BE A RECORD NUMBER FOR SOME VERBS* THE 
SEQUENCE NUMBER FOR OTHERS* OR AN INCREMENT AMOUNT, THE 
BRACKETED CONSTRUCT IS ONLY A FORM OF NOTATION USED TO REPRESENT 
AN INTEGER PARAMETER. 
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program operation and record sequencing 

during creation and file maintenance* r/c automatically 
advances (by the current value of the "i ncrement" ) the sequence 

number of each record that is input. the user may set this , 

Increment to any desired value through use of the "*inc" verb 
(see below). the increment value is initialized to 100 when the 
user first runs r/c. , 

the initial sequence number is set to the increment when a , 

new file is opened by a user. for example* if the current 
increment were 100* the first sequence number in the file would 
be -loot", this initial sequence number may be changed by the , 

USER THROUGH THE USE OF THE CONSTRUCT "*<N>"* (SEE BELOW). 

AFTER EACH RECORD IS TYPED INTO THE FILE' THE SEQUENCE 
NUMBER OF THE NEXT RECORD IN THE FILE IS SET TO THE LAST SEQUENCE 

NUMBER PLUS THE INCREMENT. THIS SEQUENCE NUMBER IS NEXT TYPED ON { 

THE TELETYPEWRITER. 

IF THE FILE TYPE IS NOT "COBOL"* THE SEQUENCE NUMBER IS 
FOLLOWED BY A COLON. IF A RECORD ALREADY EXISTS WITH THIS 

SEQUENCE NUMBER* LEADING ZEROS ARE TYPED AS A WARNING; OTHERWISE < 

LEADING ZEROS ARE SUPPRESSED. AFTER THE SEQUENCE NUMBER IS TYPED 
OUT* THE USER MAY THEN ENTER THE DESIRED CONTENTS FOR THAT 

SEQUENCE NUMBER OR MAY ENTER A VERB TO PERFORM SOME OTHER t 

FUNCTION. 

ALTERNATIVELY* THE USER MAY SET THE SEQUENCE TO SOME OTHER 
VALUE THROUGH THE USE OF THE CONSTRUCT "*<N>"* WHERE <N> IS THE 

DESIRED SEQUENCE NUMBER. NOTE THAT LEADING ZEROS ARE ACCEPTED t 

BUT NOT NECESSARY WITH THIS CONSTRUCT. 

BY USE OF THE "*<N>" CONSTRUCT AND THE "*INC" VERB TO SET 
THE SEQUENCE NUMBER INCREMENT* THE USER MAY SET UP HIS OWN 



NUMBERING SEQUENCE THROUGHOUT HIS FILE. 



< 



THE EXAMPLES ILLUSTRATE THE SEQUENCE NUMBER OF THE RECORD i 

TYPED ON THE LEFT SIDE OF THE PAGE AS IT APPEARS ON THE 
TELETYPEWRITER AND THE MANNER IN WHICH THESE RECORDS ARE 

INCREMENTED. ALTHOUGH ALGOL* XALGQL' BASIC AND FORTRAN FILES t 

ACTUALLY CARRY THE SEQUENCE NUMBER IN CHARACTER POSITIONS 73-80 
OF THE RECORD* R/C TYPES THE NUMBER ON THE LEFT MARGIN OF THE 

I 



TELETYPEWRITER, 
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INITIAL REMOTE TERMINAL OPERATIONS 



FOR LOGGING-IN TO A TELETYPEWRITER* PRESS THE "QRJG" BUTTON* 
WAIT FOR A DIAL TONE FROM THE SPEAKER, AND DIAL THE COMPUTER 
NUMBER. THE B5500 RESPONDS WITH THE MESSAGE! 



BURROUGHS B-55001 <TT>/<BB> 



(THE STATION NUMBER IS <TT>/<BB> WHERE <TT> IS THE 
TERMINAL NUMBER AND <BB> IS THE BUFFER NUMBER.) 



YOU MAY TYPE! 

? LI I <USERCODE>/<AUTHENTlCATlON CODE>* 



THIS LOG-IN MESSAGE MAY HAVE BEEN PRECEDED BY A "?BO«-" 
MESSAGE WHICH WOULD HAVE BLACKED OUT THE LINE ON WHICH THE 
LOG-IN MESSAGE WAS TYPED. 



THE B5500 VALIDATES THE <USERCODE> AND <AUTHENTlCATlON- 
CODE> AND RESPONDS BY TYPING OUT THE STATION NUMBER AND THE 
TIME OF DAY OF THE LOG-IN. 



TO CONNECT A REMOTE TERMINAL TO R/C, ENTERI 
?? RUN H/CJEND,* 



THE B5500 RESPONDS BY EITHER TYPING OUT A "BOJ" (BEGINNING 
OF JOB) MESSAGE, A "SCHEDULED" MESSAGE, OR A "RUNNING" MESSAGE. 
A "BOJ" MESSAGE INDICATES THAT R/C WAS NOT PREVIOUSLY RUNNING BUT 
HAS NOW BEEN ENTERED INTO THE Mix AND IS READY FOR USE. A 
"SCHEDULEO" MESSAGE INDICATES THAT R/C WAS NOT PREVIOUSLY RUNNING 
AND IS SCHEDULED. IN THIS CASE, R/C IS NOT BROUGHT INTO THE MIX 
UNTIL OTHER SYSTEM USERS COMPLETE THEIR WORK. THE "RUNNING" 
MESSAGE INOICATES R/C IS ALREADY IN THE MIX. 
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WITH R/C IN THE MIX, IT AUTOMATICALLY SEARCHES OUT AND LOCKS 
ONTO REMOTE TERMINALS WHICH HAVE REQUESTED CONNECTION (BY "RUN R/ 
C">, AS SOON AS YOUR TERMINAL IS LOCKED* R/C TYPES ONE OF THE 
FOLLOWING MESSAGE SEQUENCES, ACCORDING TO THE MANNER IN WHICH R/C 
ENDED DURING YOUR LAST R/C RUN (FIRST-TIME USERS ARE CONSIDERED 
TO HAVE CAUSED NORMAL LAST ENTRIES)! 



INITIAL MESSAGE AFTER NORMAL TERMINATION OF LAST RUNI 



<R/C VERSION NUMBER> 
HELLO <USERC0DE> 

I 



INITIAL MESSAGE AFTER w * END X" OR ABNORMAL LAST RUN 
TERMINATION! 

IF A FILE WAS OPEN 

<R/C VERSION NUMBER> 

<FILE NAME OF OPEN FlLE> 

HELLO+<USERCQDE> 

<SEQUENCE NUMBER IN THE OPEN FlLE>: 

OR IF NO FILE IS OPEN 

<R/C VERSION NUMBER> 

HELLO+<USERCODE> 

I 



IF A MESSAGE HAS BEEN SENT FROM ANOTHER USER TO YQUR 
USERCODE (SEE THE MAIL VERB), "MAIL X" IS TYPED INSTEAD OF 

"HELLO". 

EXAMPLES! 



VERSION # 
HELLO BLUM 
I 



THIS IS THE NORMAL INITIAL SEQUENCE FROM R/C. 



VERSION t 
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HELLO* WILNER 
I 



THIS SEQUENCE INDICATES THAT R/C REMEMBERS THE USERS 
STATE FROM THE PREVIOUS RUN. THE STATE INCLUDES THE 
INCREMENT VALUE* TAB AMOUNT* SAVE FACTOR* PERCENT QN-OFF* 
AND VERB REPLACEMENTS, 

VERSION # 
FILE/NAME 
HELLO+ SHARPE 
000506001 

THIS SEQUENCE INDICATES THAT USER HAS THE FILE "FILE/ 
NAME" OPEN AND IS AT THE RECORD WITH SEQUENCE NUMBER 50600. 
THE LEADING ZEROS INDICATE THAT A RECORD ALREADY EXISTS WITH 
THAT NUMBER. 

FINAL REMOTE TERMINAL OPERATIONS 

THE USER SHOULD TERMINATE HIS USE OF R/C WITH THE n * END" 
COMMAND (SEE BELOW). R/C WILL RESPOND WITH "GOOD BYE." 

AFTER HE HAS ENDED R/C* IF THE USER IS DONE WITH THE REMOTE 
TERMINAL HE SHOULD LOG-OUT BY ENTERING! "?LQ*" 

i 

R/C INPUT 

i 

input to r/c is either commands or records. 4 

commands are indicated by the character n *« in the first i 

input position. (if there is no open file* the "*" is optional.) 
all other input is considered records to be placeo in the open 

file, the format for a command is the "*" followed by an r/c i 

verb and* if needed* its parameters. the verb and its parameters 

MUST BE SEPARATED BY A DELIMITER. 

i 

A DELIMITER IS EITHER A SPACE OR ANY SPECIAL CHARACTER 
EXCEPT A M ;"* A " ,,M * A ","» A H C* OR A H [", MULTIPLE I 

DELIMITERS ARE TREATED AS A SINGLE DELIMITER, 
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A COMMAND MAY BE FOLLOWED BY ANOTHER INPUT (EITHER A COMMAND 

OR A RECORD) IF IT IS TERMINATED BY A "'"• AN ERROR IN A COMMAND 

OF A MULTIPLE INPUT INHIBITS THE PROCESSING OF THE REST OF THAT 
INPUT, 



EXAMPLESj 

1001* INC 50* 

THIS IS AN EXAMPLE OF ONE OF THE INPUT COMMANDS. 

lOOlBEGlN* 

THIS IS AN EXAMPLE OF PLACING A RECORD AT SEQUENCE 
NUMBER 100. 

1001* INC 3;* RESEQ* 

THIS IS AN EXAMPLE OF MULTIPLE COMMANDS, 

1001*35; THIS RECORD GOES AT 35* 

THIS IS AN EXAMPLE OF A COMMAND FOLLOWED BY A RECORD OF 
INPUT, 

1001* OPEN A/B DATAi* PRINT FOR ME;*CLOSE* 

THIS IS ANOTHER EXAMPLE OF MULTIPLE COMMANDS, NOTE 
THAT THE "*" MUST APPEAR IN THE NEXT CHARACTER POSITION 
FOLLOWING THE SEMICOLON OR THE REMAINDER OF THE RECORD IS 
TREATED AS DATA, 

AN INPUT LINE IS SENT TO THE COMPUTER BY TYPING THE 
CHARACTER "«■", TYPING ERRORS CAN BE CORRECTED* BY BACKSPACING 
AND LINE ERASING, BEFORE A MESSAGE IS SENT, THE BACKSPACE 
CHARACTER IS THE APOSTROPHE (SHIFT 7) AND THE LINE ERASE 
CHARACTER IS THE UP-ARROW (SHIFT N), ALL THE FOLLOWING LINES OF 
INPUT ARE EQUIVALENT (NOTE THE UNDERLINED CHARACTERS REPRESENT 
USE OF THE SHIFT)I 

1001THIS IS IT* 

100ITHIS IS NOT, BUTNTHIS IS IT* 
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100JTHE7IS IS IT* 

m 

100JTHESE777IS IS IT* 



IF, AFTER BACKSPACING AND LINE ERASING, THE INPUT LINE 
CONTAINS MORE THAN 2*0 CHARACTERS* THE INPUT IS DISCARDED WITH AN 
♦♦INPUT OVERFLW" ERROR MESSAGEi DATA RECORDS ARE ALSO DISCARDED 
(WITH THE ERROR MESSAGE) IF THEY ARE TOO LARGE FOR THE FILE. (It 
E, GTR 66 FOR COBOL FILES; GTR 80 FOR DATA FILES, AND GTR 72 FOR 
ALL OTHER FILES) 

THERE ARE TWO CLASSES OF REQUESTS TO R/C» LONG AND SHORT. 
LONG OPERATIONS ARE THOSE THAT USUALLY ARE SLOW TO EXECUTE AND 
ARE CHARACTERIZED BY THE "WAIT..," MESSAGE. ALL OTHER REQUESTS 
ARE CLASSIFIED AS SHORT OPERATIONS. LONG OPERATIONS ARE 
SOMETIMES QUEUED BEFORE THE "WAIT..." MESSAGE* TO BE EXECUTED 
ONE AT A TIME, SHORT REQUESTS ARE DONE AS THEY ARE RECEIVED. 
THE USERS IN THE LONG REQUEST QUEUE (AND THE USER PERFORMING A 
LONG OPERATION IF IT IS NOT TYPING ON THE REMOTE) PERIODICALLY 
RECEIVE * FEW "RUBOUT" CHARACTERS OF REASSURANCE, R/C IGNORES 
ANY INPUT SENT BY USERS IN THE QUEUE OR BY THE USER WHOSE LONG 
OPERATION IS BEING PROCESSED, 

IF A USER PRODUCES NO INPUT FOR FIVE MINUTES, HE IS SENT THE 
MESSAGE "LOOK ALIVE". IF HE DOES NOT RESPOND WlTHlN ANOTHER FIVE 
MINUTE PERIOD, R/C PROCESSES A "* END DS" FOR THAT USER, 



R/C OUTPUT 



OUTPUT TO THE TELETYPEWRITER OF THE SPECIAL CHARACTERS ** X, 
<, <, >, AND > IS REPLACED BY A "S" CHARACTER IN ORDER THAT THEY 
DO NOT EVOKE TELETYPWRITER CONTROL FUNCTIONS WITH WHICH THEY ARE 
ASSOCIATED. (THESE INCLUDE LINE-FEED, CARRIAGE-RETURN, MESSAGE- 
END, AND PAPER-TAPE-ON,) 

WHEN THE "BREAK" KEY IS DEPRESSED DURING OUTPUT, THE OUTPUT 
IS TERMINATED WITH THE MESSAGE "BREAK", 
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ALL FILES CREATED BY R/C ARE PERMANENT DISK FILES. THE SAVE 

factor is normally t days* but it may be changed by the save verb 



(SEE BELOW), 
FILE TYPES 



R/C ENABLES THE USER TO CREATE AND MAINTAIN ALGOL* COBOL* 
FORTRAN* XALGOL* BASIC, AND DATA FILES. THESE FILES HAVE 80 
CHARACTER-LONG RECORDS, (ONE CARD IMAGE). 



XALGOL* BASIC* ALGOL AND FORTRAN FILES CONTAIN EIGHT DIGIT 
SEQUENCE NUMBERS LOCATED IN THE POSITIONS 73-8Q OF THE CARD IMAGE. 



COBOL FILES CONTAIN SIX-DIGIT SEQUENCE NUMBERS, PLACED IN 
POSITIONS 1-6 OF THE RECORD. 



DATA FILES ARE NOT PHYSICALLY SEQUENCED ALTHOUGH R/C 
MAINTAINS AN INTERNAL* EIGHT-DIGIT NUMBER FOR EACH RECORD. 



FILE NAMES 



FILE NAMES MUST BE SUPPLIED TO R/C, THE FORM OF A NAME IS 
<FILE PREFIX> / <FILE SUFF!X>, THROUGHOUT THIS DOCUMENT* <FlLE- 
NAME> IS USED TO SPECIFY A FILE AND SHOULD BE IN THE FORM ABOVE, 
THE <FlLE PREFIX> AND THE <FILE SUFFIX> MAY EACH BE NO LONGER 
THAN SEVEN CHARACTERS, 



EXAMPLES! 

A/B 

GRIMY/GULCH 

ZAP/1 

16JAN/SUFFIX 

OOOOOOO/DISK 
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RECORD REFERENCING 



records in the open file (see open below) are referred to by 
their sequence number. "data" files are implicitly sequenced by 
the value of the increment when they are openedt 

an alternate method of referencing records in the open file 
is relative sequence numbers. a relative sequence number is an 
Integer preceeded by a ♦ or • sign, it may be used anyplace a 
sequence number is used. it is translated to a sequence number 
by moving forward or backward the indicated number of records and 
using the sequence number of that record, 

RECORDS IN A NON-OPEN FILE (EXTERNAL FIlE) ARE REFERRED TO 
BY THEIR RELATIVE POSITION WITHIN THE FILE* THE FIRST RECORD IS 
If THE SECOND 2* ETC. ANY SEQUENCING THAT MAY BE ON THE RECORDS 
IS IGNORED. 



I 

i 
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FILE-HANDLING VERBS 



THIS SECTION DESCRIBES 
RATHER THAN RECORDS WITHIN 
OPTIONS IN R/C SYNTAX THAT 
FILE. THE COMPLETE SYNTAX 
DISCUSSION ANO EXAMPLES OF 
ALWAYS BE THE FIRST CHARACTER 



VERBS THAT HANDLE FILES AS A WHOLE* 

A FlLEt HOWEVER* A FEW VERBS HAVE 

PERMIT ACCESS TO RECORDS WITHIN THE 

IS GIVEN FOR EACH VERB AS WELL AS A 

ITS USE. AN ASTERISK ("*") MUST 

IN THE INPUT STRING WHEN A COMMAND 



IS ENTERED, 
OVERWRITTEN BY 



IF THIS IS NOT FOLLOWED* 
THE COMMAND ITSELF, 



AN EXISTING RECORD MAY BE 
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FILE OPENING AND CREATION (OPEN) 



* OPEN <FILE-NAME> <FILE-TYPE> NEW 



* OPEN <FlLE-NAME> <FiLE-TYPE> OLD 



* OPEN <FILE-NAME> <FILE«TYPE> 



THE "* OPEN " VERB ATTACHES THE USER TO THE DISK FILE <FlLE* 
NAME>, THE <FILE-TYPE> MUST BE EITHER "ALGOL"* "COBOL"* 
"FORTRAN". "XALGQL"* "BASIC"* OR "DATA", IF THE <QPEN TYPE> IS 
"NEW". A NEW DISK FILE IS CREATED, IF THE <OPEN TYPE> IS "OLD". 
THE DISK FILE <FlLE-NAME> IS OPENED AND RESEQUENCED BY THE 
CURRENT VALUE OF THE INCREMENT. IF THE <OPEN TYPE> IS NEITHER 
"NEW" NOR "OLD" THE DISK FILE <FILE'NAME> IS OPENED AND IT IS 
READ TO DETERMINE ITS SEQUENCE NUMBERS. THIS LATTER FORM Is 
SLOWER THAN THE OPEN "OLD", 



EXAMPLES! 



»* OPEN PROGRAM/SOURCE ALGOL NEW* 
1001 

THIS CREATES A NEW DISK FILE CALLED PROGRAM/SOURCE. 



635001* OPEN ANOTHER/PROG DATA OLD* 
45001 

THIS OPENS THE FILE ANOTHER/PROG SEQUENCING IT BY THE 
CURRENT INCREMENT VALUE. NOTE THAT THE FILE THAT WAS OPEN 
IS FIRST CLOSED BEFORE THE NEXT FILE IS OPENED, 



t* OPEN YET/ANOTHER COBOL* 
WAIT,,. 

READ ONLY FILE. 
7504 

THIS OPENS THE FILE YET/ANOTHER USING THE SEQUENCE 
NUMBERS WITHIN THE FILE, THE MESSAGE "READ ONLY FILE" 
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INDICATES THAT THE USER IS FORBIDDEN (BY THE FILE SECURITY 
SYSTEM) TO MODIFY THE FILE, 



ERRORS! 



DUP FILE* <FILE-NAME> 



A FILE* <FILE-NAME>* ALREADY EXISTS AND THE USER IS 
TRYING TO CREATE A FILE WITH THAT NAME WITH AN "* OPEN ... 

NEW", 



NO FILE! <FILE-NAME> 

THE USER IS TRYING TO OPEN A FILE* <FILE-NAME>* AND IT 
DOES NOT EXIST ON DISK, 

BAD FILE! <FILE-NAME> 

THE FILE <FILE-NAME> WHICH THE USER IS TRYING TO OPEN 
IS NOT BLOCKED CORRECTLY, THE CORRECT BLOCKING IS 10-WORD 
RECORDS WITH A MULTIPLE OF 3 RECORDS PER BLOCK. 

INV USER1 <FILE-NAME> 



THE USER IS TRYING TO OPEN A FILE TO WHICH HE HAS NO 
ACCESS, IF THE USER HAS EITHER SECONDARY OR TERTIARY 
ACCESS* THE MESSAGE! "READ ONLY FILE" IS TYPED. 



FILE TOO LONG 



THE USER IS TRYING TO OPEN A FILE WITH MORE THAN 8191 
RECORDS, 



SEQ OVERFLOW 



THE FILE THE USER IS OPENING CAUSES THE SEQUENCE 
COUNTER TO EXCEED 2*097*151. THE FILE IS OPENED* BUT THE 
USER SHOULD RESEQUENCE IT, 
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SEQ ERR-<N> 



THE FILE CONTAINS A RECORD WHOSE SEQUENCE NUMBER <N> IS 
LESS THAN THE SEQUENCE NUMBER OF THE PRECEEDlNG RECORD. THE 
FILE IS NOT OPENED. 



BAD FILE TYPEI <FILE"TYPE> 



<FILE"TYPE> IS NOT "ALGOL"* "COBOL"* "FORTRAN"* 
"XALGOL"* "BASIC", OR "DATA", 
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FILE CLOSING (CLOSE) 



FILES ARE CLOSED BY USE OF THE FOLLOWING CONSTRUCT! 
* CLOSE 



THIS VERB DETATCHES THE OPEN FILE* FROM R/C. 

EXAMPLES! 

56001* CLOSE* 
i 

THIS IS AN EXAMPLE OF CLOSING A FILE THAT IS IN THE 
CORRECT ORDER. 



4501* RESEQ 100* 
90©0«* CLOSE* 
WAIT... 

! 

THIS IS AN EXAMPLE OF CLOSING A FILE THAT IS NOT IN 
ORDER, 



ERROR! 

NO FILE OPEN! CLOSE 
THERE IS NO OPEN FILE TO CLOSE. 
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LISTINGS ON THE TELETYPEWRITER (LIST) 



TO LIST FILES OR ANY OF THEIR SEPARATE RECORDS* THE 
FOLLOWING CONSTRUCTS APPLY: 



* LIST 



* LIST <FILE-NAME> 



* LIST <FILE-NAME> NO 



* LIST <FILE-NAME> <M> 



* LIST «FILE-NAME> <M> <N> 



* LIST <M> 



* LIST <M> <N> 

THE M LlST M VERB CAUSES AN ENTIRE FILE OR PORTIONS OF A FILE 
TO BE LISTED ON THE TELETYPEWRITER. LISTING MAY BE DISCONTINUED 
BY PRESSING THE BREAK KEY ON THE TELETYPEWRI TER. 

THE FIRST FORM LISTS THE OPEN FILE, 

THE SECOND FORM LISTS THE FILE <FlLE-NAME>. 

THE THIRD FORM LISTS THE FILE <FlLE-NAM£>* WITHOUT THE 
RECORD NUMBERS, 
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THE FOURTH FORM LISTS <FILE"NAME> FROM THE <M>TH RECORD 
TO THE END. 



THE FIFTH FORM LISTS <FILE-NAME> FROM THE <M>TH TO THE 
<N>TH RECORDS, 

THE SIXTH FORM LISTS SEQUENCE NUMBER <M> OF THE OPEN 
FILE. 



THE LAST FORM LISTS SEQUENCE NUMBERS <M> THROUGH <N> OF 
THE OPEN FILE. 



EXAMPLES! 



5001* LIST* 

lOOIBEGIN 

200» INTEGER I* J* K ) 

300» REAL X# Y, Z ; 

4001 ARRAY HO I 9] J 

500J 



( 



55001* LIST 8900»+3* 

89501 I t» I * 5 ; ( 

9125J GO TO NEXT ; 

9300« HELP* 

94001 i 



300* LIST 60* 
000060 MOVE A TO B, 
000070 



J* LIST SQME/FILE* 

HBEGIN 

2» INTEGER I# J* K ; 

3« REAL X* Y» Z ; ( 

41 ARRAY MO I 9] J 

51 A tn •■ X J 

6IEND, | 

I 

500!* LIST SOME/FILE NO* I 

BEGIN 
INTEGER I» J# K J 

REAL X, Y, Z i , 

ARRAY A CO * 93 ; 
A [I] J* X ; 
END. i 

500J 



t * 



J 
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t* LIST LIBRARY/FILE 2>a* 

2IPR0CE0URE REAODATA 567,653 
3IPROCEDURE WRITEDATA 654*789 
4IPR0CE0URE DATA 790#808 

t 



LIST SOME/FILE 5* 

5» A til l" 

6JEND, 



x ; 



»* LIST SOME/FILE 
USE RECORD #S, 

» 



200*500* 



THE LAST EXAMPLE ILLUSTRATES THE COMMON ERROR OF 
REFERENCING AN EXTERNAL FILE WITH SEQUENCE NUMBERS INSTEAD 
OF RECORD NUMBERS, 



i 

t 
i 
i 
i 
f 
t 
t 
4 
i 
i 
i 
i 

4 
< 
( 
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COMPRESSED FILE LISTINGS (QUICK) 



A COMPRESSED FILE LISTING MAY BE OBTAINED FROM R/C BY USE OF 
THE CONSTRUCTS! 



* QUICK 



* QUICK <FILE-NAME> 



* QUICK <FILE-NAME> NO 



* QUICK <FILE-NAME> <M> 



* QUICK <FILE-NAME> <M> <N> 



* QUICK <M> 



* QUICK <M> <N> 



THE "* QUICK" VERB LISTS ON THE TELETYPEWRITER DELETING ALL 
CONTIGUOUS BLANKS EXCEPT THE FIRST. THE FILE IS NOT AFFECTED BY 
THE VERB, 



EXAMPLE! 



4500J* LIST 4300»4400«- 

43001 FOR I l* A STEP '1 UNTIL 

4400J X CI3 »= SIN (Y) ; 

45S01* QUICK -2# ♦ 1* 

4360» FOR I »■ A STEP "X UNTIL DO 

4400« X [13 «s SIN CY) ; 

4500» 



DO 
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FILE REMOVAL (REMOVE) 



TO REMOVE A FILE USE THE FOLLOWING CONSTRUCT: 



* REMOVE <FILE-NAME> 



THE REMOVE VERB REMOVES THE FILE <FlLE-NAME> FROM DISK, 



* REMOVE LISTING 



REMOVES LlNE/<USERCODE># THE LISTING FILE FROM THE LAST 
COMPILATION, 



EXAMPLES! 



32001* REMOVE A/8* 

3200J 

5461* REMOVE ANOTHER/FILE* 
NO FILEI ANOTHER/FILE 
5461 



«* OPEN EXAMPLE/X COBOL OLD* 
46500* REMOVE EXAMPLE/X* 
J 
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LINE-PRINTER FILE REPRODUCTION (PRINT) 



THE PRINT VERB' 



*PRINT <A> <B> 



PRINTS THE OPENED FILE ON THE LINE PRINTER (LABELED <A> 
<B>). IF "<B>" IS "DOUBLE" THEN DOUBLE SPACING IS USED. 



* PRINT <A> <B> <M> 



AS ABOVE, STARTING WITH SEQUENCE NUMBER <M>, 



* PRINT <A> <B> <M>* <N> 



AS ABOVE, STOPPING WITH SEQUENCE NUMBER <N>, 



EXAMPLES! 



«* OPEN 
I 



TEST/CASE DATA;* PRINT TC DOUBLE)* CLOSE* 



THIS EXAMPLE ILLUSTRATES AN INSTANCE WHERE A SEQUENCED 
FILE SHOULO BE TREATED AS DATA TO SHORTEN THE OPERATION. IF 
THE FILE WAS OPENED "ALGOL OLD" IT WOULD HAVE BEEN 
RESEQUENCED BY THE CURRENT VALUE OF THE INCREMENT AND THEN 
WHEN IT WAS GLOSED IT WOULD HAVE BEEN RECOPIED. IF IT WAS 
OPENED "ALGOL" IT WOULD HAVE BEEN READ TO DETERMINE ITS 
SEQUENCE NUMBERS. EITHER WAY WOULD HAVE MADE THE WHQLE 
OPERATION MUCH SLOWER THAN OPENING THE FILE "DATA". 

8700'* PRINT FOR USER* 
WAIT.., 
87Q0* 
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PUNCHED-CARD FILE REPRODUCTION (PUNCH) 

TO PUNCH A FILE! 
* PUNCH <A> <B> 



PUNCHES A CARD DECK (LABELED <A> <B>) OF THE OPENED 
FILE. 



* PUNCH <A> <B> <M> 



AS ABOVE, STARTING WITH SEQUENCE NUMBER <M>, 
* PUNCH <A> <B> <M># <N> 

m «•••■■■ m mm mmm m mmm *•• 

AS ABOVE* STOPPING WITH SEQUENCE NUMBER <N>. 
EXAMPLEJ 

7600»* PUNCH A B iOO>+10* 
WAIT... 
7600! 
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FILE COMPILATION (COMPILE) 



FILES MAY BE COMPILED TO THE B5500 LIBRARY BY THE FOLLOWING 
CONSTRUCTI 



* COMPILE <FILE-NAME> 



THIS VERB INITIATES THE COMPILATION OF THE OPEN FILE TO 
LIBRARY USING THE COMPILER INDICATED IN THE OPEN STATEMENT. 
THE OBJECT CODE IS NAMED <FILE-NAME>, THE LISTING OUTPUT OF 
THE COMPILATION IS EQUATED TO "L lNE/<USERCODE>" ON DISK, 
THE "* LISTING" VERB MAY BE USED TO LIST THE SYNTAX ERRORS, 



* COMPILE <FILE-NAME> <CQMPlLER> 



COMPILES THE OPEN FILE USING THE SPECIFIED COMPILER. 



EXAMPLES! 



5700»* COMPILE OBJECT/CODE* 
WAIT... 
I 

4791* COMPILE TEST/OBJECT EZTRAN* 
QUEUEDC D.WAIT,.. 

1 



IN THE LAST EXAMPLE* THE "EZTRAN" COMPILER (EZTRAN/ 
DISK) WILL BE USED. IF THE FILE IS NOT IN ORDER* IT WILL BE 
REORDERED, SINCE THIS IS A LONG OPERATION THE USER GETS A 
"WAIT" MESSAGE* THE "QUEUED" MESSAGE INDICATES THAT ANOTHER 
USERS LONG OPERATION IS BEING PROCESSED AND THAT THIS LONG 
OPERATION IS QUEUED UNTIL THE OTHER IS DONE. THE "1" 
INDICATES THAT THIS IS THE FIRST REQUEST IN THE QUEUE. 
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OUTPUT OF THE COMPILATION (LISTING) 



THE LISTING FILE OF THE COMPILER IS EQUATED TO LINE/ 
<USERCOOE> ON DISK. THE FILE MAY BE ACCESSED BY THE USE OF THE 
LISTING VERB! 

* LISTING <FILE-TYPE> <S># <L>» <U> 



LISTS THE SEQUENCE NUMBERS RELATED TO SEGMENT <S> FROM 
RELATIVE ADDRESS <L> TO RELATIVE ADDRESS <U>, <FILE»TYPE> 
IS ALGOL* XALGOL* BASIC COBOL' OR FORTRAN AND INDICATES 
WHICH COMPILER CREATED THE LISTING FILE "LINE/<USERCODE>» , 
(THIS FILE IS AUTOMATICALLY GENERATED BY THE COMPILE VERB), 



* LISTING <FILE*TYPE> ERRORS 



LISTS THE SYNTAX ERRORS OF YOUR LAST COMPILATION, 
* LISTING 



PRINTS THE LINE FILE OF YOUR LAST COMPILATION ON THE 
PRINTER. 



EXAMPLES! 



»* LISTING ALGOL 5» 25* 35* 

WAIT... SEGMENT « 51 

4300« REL. ADDR. » 26, 
<U00« REL, ADDR. * 29, 
9200» REL. ADDR. * 32. 
9300« REL, ADDR, « 35, 

«* LISTING ALGOL ERRORS* 

WAIT,., 

7800SERR0R 100 I, 

l 

8900»* LISTING* 
8900» 
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FILE ZIPPED AS AN "EXECUTE" DECK (ZIP) 



TO IMPLEMENT THE 
FOLLOWING CONSTRUCT' 



B5500 ZIP FUNCTION THROUGH R/C, USE THE 



ZIP 



THIS CONSTRUCT 
THE CONTROL CARDS 
REFERENCE MANUAL FOR 
STATEMENT. 



ZIPS THE OPENED FILE AFTER IT LINKS ALL 
AS INDICATED BY "?". SEE THE ALGOL 
A DESCRIPTION OF THE "ZIP WITH FILEMO" 



* ZIP <FILE-NAME> 



COPIES THE OPENED FILE CREATING <FlLE-NAME> AND ZIPS 
<FILE-NAME>. NOTE THIS "ZIP" CONSTRUCT DOES NOT DESTROY THE 
OPEN FILE, AS DOES THE FIRST FORM. 



EXAMPLES* 



ICOLUMN ON "?"KOLUMN 73* 

JOPEN MAKE/MANUAL DATA NEW; %%EXECUTE XREF/JONES , * 

200IXXFILE DISK * TEACHER/0000094 .* 

3001*% DATA CARD.* 

4001$ DISK SIX DOCONLY DOCUMENT FINAL* 

500JP99999999* 

6001*% END.* 

7001* ZIP TEMP/NAME* 



WAIT 



. » * 

7001 



THIS EXAMPLE ILLUSTRATES HOW TO CREATE A CONTROL DECK 
AND INITIATE ITS EXECUTION. THE DECK WAS SAVEO (UNDER THE 
NAME "MAKE/MANUAL") SINCE THE ZIP CONSTRUCT INCLUDED THE 
DUMMY FILE "TEMP/NAME". (NOTE THAT THE ABOVE DECK WILL 
CREATE AN R/C USERS MANUAL.) 



I* OPEN 
WAIT... 
I 



MAKE/MANUAL DATA;* ZIP T/N;* CLOSE* 
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RECORD HANDLING VERBS 



( 
i 

< 
< 
< 
t 
i 
< 
i 
< 
< 

I 
< 
i 
i 
i 

« 
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RECORD COPYING (DITTO) 



RECORDS MAY BE COPIED FROM ONE PLACE TO ANOTHER WITHIN A 
FILE BY THE CONSTRUCTl 



* DITTO <M> 



COPIES CARD IMAGE <M> AS THE NEXT RECORD, 



* DITTO <M>, <N> 



COPIES THE CARD IMAGES <M> TO <N> AS THE NEXT RECORDS. 



* DITTO OVERITE ON 



* DITTO OVERITE OFF 



* DITTO OVERITE 



IF THE DITTO OVERITE IS OFF AND AN EXISTING RECORD IS 
ABOUT TO BE OVERWRITTEN* THE DITTO TERMINATES WITH AN 
"OVERITE OFF" MESSAGE. (IT IS INITIALLY OFF.) THE ABOVE 
COMMANDS ARE USED TO SET THE OPTION AND TO PRINT ITS CURRENT 
SETTING. ITS SETTING MAY BE REVERSED FOR ONE COMMAND BY 
PREFIXING THE DITTO WITH A -. (E.G. *-DlTTO 10,50.) 



* DITTO <M> MOVE 



* DITTO <M>, <N> MOVE 



THE MOVE OPTION, MOVES RECORDS <M> THRU <N> TO THE 



< 
i 
f 

l 
i 

t 
< 

c 

c 

i 

i 
i 
i 
i 



CURRENT LOCATION, 
IS NOT ALLOWED. 
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THIS OPTION IS VERY FAST* BUT OVERITING 



EXAMPLES! 



5001* DITTO 

7001* LIST* 

100IONE 

200ITW0 

300ITHREE 

4001F0UR 

500ITWO 

600ITHREE 

700«* DITTO 

100J0NE 

400IFOUR 

500ITW0 

600ITHREE 

700ITW0 

800JTHREE 

9001 



200#300* 



200»3oo move;*list* 
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COPYING EXTERNAL FILES (COPY) 



WHOLE OR PARTIAL EXTERNAL FILES MAY BE COPIED INTO THE 
CURRENTLY OPENED FILE BY THE CONSTRUCTS! 



* COPY <FILE-NAME> 



* COPY <FILE-NAME> <M> 



* COPY <FILE-NAME> <*>* <N> 



* COPY <FILE»NAME> MERGE 



THE COPY VERB COPIES RECORDS FROM ANOTHER FILE (<FlLE- 
NAME>). 



THE FIRST FORM COPIES THE WHOLE FILE* THE SECOND FORM 
COPIES THE <M>-TH RECORD (WHERE THE FIRST RECORD OF <FlLE- 
NAME> IS If THE SECOND RECORD IS 2* THE THIRD IS 3* ETC.), 
THE THIRD FORM COPIES THE <M>-TH THROUGH THE <N>-TH RECORDS. 
THE LAST FORM USES THE SEQUENCE NUMBERS OF THE RECORDS OF 
<FILE-NAME> TO DETERMINE THEIR POSITION IN THE OPEN FILE. 



* COPY OvERITE ON 



* COPY OVERITE OFF 



* COPY OyERITE 



* 

f 
* 



if the copy overite is off and an existing record is 
about to be overwrlttenf the copy terminates with an 
"oveRite off" m e ssage. (it is initially off.) the above 
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commands are used to set the option and to print its current 
setting, its setting may be reversed for one command by 
prefixing the copy with a -, (e.g. *-copy a/b 10*50.) 



EXAMPLES} 



I* OPEN S0URCE/MARK7 ALGOL NEW* 

1001* COPY SQURCE/MARK6* 
WAIT,,, 

8900J 

500!* COPY LIBRARY/FILE 345* 368* 
WAIT... 

28001 

IOUICK PATCH/FILE* 

1 1 A 00000050 

2IB 00000150 

3»C 00000200 

MX 00000175 

5»Y 00000250 

6tZ 00000250 
tOPEN MY/SOURCE ALGOL OLD* 

4001* COPY OVERITE 0N;*CQPY PATCH/FILE MERGE* 
400»* LIST* 

501 A 
iOOIl 
150IB 
175«X 
200»C 
250IZ 
30013 
4005 
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INTFU-RECORD EDITING (INLINE) 



RECORDS MAY BE EDITED BY USE OF THE "* INLINE" CONSTRUCTS 
DESCRIBED IN THE NEXT PARAGRAPHS, 

* INLINE <M> 



* INLINE 



* INLINE <M> <EDIT CHR> 



* INLINE <EDIT CHR> 



THIS SETS UP LINE <M> FOR INLINE EDITING. IF THE SEQUENCE 
NUMBER <M> IS NOT INCLUDED WITH THE COMMAND* THE PREVIOUS RECORD 
IS USED AND THE INITIAL PRINTING OF IT IS SUPPRESSEDt 



* INLINE ECHO ON 



* INLINE ECHO OFF 



* INLINE ECHO 



THE MODIFIED RECORD WILL BE TYPED ON THE TELETYPE IF THE 
INLINE ECHO IS ON. (IT IS INITIALLY ON.) THE ABOVE COMMANDS ARE 
USED TO SET THE OPTION AND TO PRINT ITS CURRENT SETTING, ITS 
SETTING MAY BE REVERSED FOP ONE COMMAND BY PREFIXING THE INLINE 
WITH A -, (E.G. * -INLINE +3.) 

TO MODIFY A PORTION OF A RECORD (CARD IMAGE) USE THE "* 
INLINE" VERB. R/C PRINTS THE RECORD NUMBER AND THE LINE* THEN 
GIVES A CARRIAGE RETURN AND LINE FEED. IT NEXT SPACES THE PRINT 
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BALL (ON THE NEW LINE) DIRECTLY BELOW THE FIRST CHARACTER 
POSITION OF THE OLD LINE, ABOVE, THE USER SPACES THE PRINT BALL 
TO THE PROPER POSITION AND ACCOMPLISHES THE FOLLOWING ACTIONS! 

TO INSERT A STRING, TYPE THE LETTER "P FOLLOWED BY THE 
STRING AND A "«■", 

TO DELETE A STRING, USE THE LETTER "D" FOLLOWED BY 
SPACES UNDER THE CHARACTERS TO BE DELETED AND THEN A "•", 

TO REPLACE A STRING, USE THE LETTER "R" FOLLOWED BY THE 
NEW STRING OF THE SAME LENGTH AND A »*", 



IF THE MODIFICATION IS TO BE DONE IN THE FIRST 
CHARACTER, THEN INCLUDE THE "I", M R", OR «D" WITH THE INLINE 
COMMAND, 



EXAMPLES! 

TO INSERT CHARACTERS INTO A RECORD! 



300!*INLINE 30500* 
30500IABCDEFGHIJK 
000305001 H2345* 

305001ABC12345DEFGHIJK 



TO DELETE CHARACTERS FROM A RECORDl 



7700IMNLINE 67700* 
67700IABCDEFGHIJKLMN0P 
000677001 D * 

67700IABHIJKLMN0P 



TO REPLACE CHARACTERS IN A RECORD' 



600!* INLINE 551* 
5511ABC0EFGHIJKLMN0PQRST 
I 000005511R12345* 

5511A12345GHIJKLMN0PQRST 

4 

I 



